package com.xci.platform.auth.dao;

import com.xci.platform.auth.entity.DicEntity;
import com.xci.platform.core.ITreeOperate;
import com.xci.platform.core.Tree;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 系统字典数据访问接口
 */
@Mapper
public interface DicDao extends ITreeOperate {

    /**
     * 新增字典
     *
     * @param entity 字典对象
     * @return 返回影响的行数
     */
    Integer insert(@Param("entity") DicEntity entity);

    /**
     * 更新字典
     *
     * @param entity 字典对象
     * @return 返回影响的行数
     */
    Integer update(@Param("entity") DicEntity entity);

    /**
     * 删除字典
     *
     * @param id 字典主键
     * @return 返回影响的行数
     */
    Integer delete(@Param("id") String id);

    /**
     * 根据主键更新排序路径
     *
     * @param id   主键
     * @param path 排序路径
     */
    Integer updatePathById(@Param("id") String id, @Param("path") String path);

    /**
     * 根据主键更新父节点以及排序路径
     *
     * @param id       主键
     * @param parentId 上级主键
     * @param path     排序路径
     */
    Integer updateParentAndPathById(@Param("id") String id, @Param("parentId") String parentId, @Param("path") String path);

    /**
     * 根据主键更新叶子节点状态
     *
     * @param id   主键
     * @param leaf 叶子节点状态
     */
    Integer updateLeafById(@Param("id") String id, @Param("leaf") Integer leaf);

    /**
     * 验证指定字典编码是否存在
     *
     * @param code     字典编码
     * @param id       字典主键
     * @return 如果存在返回true, 否则返回false
     */
    Integer existByCode(@Param("code") String code, @Param("id") String id);

    /**
     * 根据字典编码获取字典对象
     *
     * @param code 字典编码
     */
    DicEntity queryByCode(@Param("code") String code);

    /**
     * 根据字典主键获取字典对象
     *
     * @param id 字典主键
     * @return 返回指定字典主键的字典对象
     */
    DicEntity queryById(@Param("id") String id);

    /**
     * 获取字典名称
     *
     * @param id 字典主键
     * @return 字典名称
     */
    String queryNameById(@Param("id") String id);

    /**
     * 获取指定主键的排序路径
     *
     * @param id 主键
     */
    String queryPathById(@Param("id") String id);

    /**
     * 根据字典编码获取字典名称
     *
     * @param code 字典编码
     */
    String queryNameByCode(@Param("code") String code);

    /**
     * 获取指定主键的子节点数
     *
     * @param id 主键
     */
    Integer queryChildCountById(@Param("id") String id);

    /**
     * 查询字典列表
     *
     * @return 返回符合查询条件的字典列表
     */
    List<DicEntity> query();

    /**
     * 动态加载字典列表
     *
     * @param id 字典主键
     * @return 字典列表
     */
    List<DicEntity> dynamicQuery(@Param("id") String id);

    /**
     * 查询Tree模型列表
     */
    List<Tree> queryTreeModelList();
}
